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documentation is prohibited. 

Copies of software for distribution may be made only as speci¬ 
fied in the accompanying documentation. 







VALPAR INTERNATIONAL 


Disclaimer of Warranty 
on Computer Programs 


All Valpar International computer programs are distributed 
on an "as is" basis without warranty of any kind, 
risk as to the quality and performance of such programs is with 
the purchaser. Should the programs prove defective following 
their purchase, the purchaser and not the manufacturer, distributor, 
or retailer assumes the entire cost of all necessary servicing or 
repair. 

Valpar International shall have no liability or responsibility 
to a purchaser, customer, or any other person or entity with 
respect to any liability, loss, or damage caused directly or 
indirectly by computer programs sold by Valpar International. 

This disclaimer includes but is not limited to any interruption 
of service, loss of business or anticipatory profits or conse¬ 
quential damages resulting from the use or operation of such 
computer programs. 

is returned to Valpar International within 30 days of date of sale 
to user. 

Defective media (diskettes) which is returned after the 30 day 
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STROLLING THROUGH THE DISPLAY FORMATTER 


In Atari Basic there are many different graphic modes. Some of these are 
ext modes, some are graphics modes, and some are mixed. These different 
graphic modes are based upon display lists. A display list is a list of display 
instructions which tell the video processor whether a particular portion of the 
creen is to be high resolution graphics or normal text. Any given section of 
he display can actually take on one of 18 different characteristics. 

Let's take a look at the display list for a graphic 0 display: (These 
values are in base 16) 



BC20 


24 blank scan lines 


DM jump to BC40 


23 graphic 0 lines 


jump to BC20 


start of display memory 


BC40 


Each opcode 70 instructs the video processor to display 8 blank scan 
ves. Opcode 2 produces one standard graphic 0 text line. Opcode 42 is a 
edified 2 instruction. In addition to creating a standard text line, it 
Iso informs the video processor where the display memory is located (the 

ettings have a similar list. This valFORTH package allows you to design your 

Look in the directory (screen 170) and load ir. the display formatter, 
ost of the formatter words begin with DB (for display block). To initialize 
t system type: 


HEX 
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This initializes the system and puts it into the more useful hexadecimal mode. 
Graphic mode 8 is a high resolution graphic mode with a four line text window 
at the bottom of the display. Let's make a display with a four line text 
window at the top of the screen followed by the high resolution graphics plate. 
First, we need 24 blank scan lines at the top: 

70 DBM 

The DBM command stands for "Display-Block Make." It takes the opcode on top of 
the stack and tacks it onto the end of the display list currently being created 
Additionally, it enters an address into the array DBLST which points to the 
first byte of memory used by that display block. There is a plural form of the 
DBM command: 


70 DBMS 

This adds 3 opcode 70's to the current display list. Now let's add the four 

line text window. Recall that a normal text line has an opcode of two: 

Note that the display memory jump described earlier is automat:.ally inserted 

the display. A standard graphic 8 line has an opcode of $F (15 in decimal). 

Let's create 20 graphic 8 lines (20 in base 16 is 14). 


DMPLST 
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BLK 

ftDDR 

0 








4 

G128 


A150 



7 


8 


9 



A218 




ft 268 



E 












14 















BYTE MODS 

7@ 

7@ 

J A100 


Note the automatic insertion of the display memory jump in block three. 

rigs caused by the display block. If the block does cross, a display memory 
jump is automatically inserted into the list to account for it. 

Now that we have a display list, let's enable it. There are several ways 
o activate a list. For now type: 


This MIXED command enables the new display list and also re-directs output 
to the display memory specified by the list, "his allows for interactive dis¬ 
play list creation. There should be a recognizably different display. Hold 
down the RETURN key and watch how the "ok" message is displayed as the cursor 
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resolution mode because the Atari operating system does not know that the 
is used: 




block. That block then becomes the end of the list. After that, we add 16 
(10 hex) graphic 0 lines. Dump the list again and verify that this is indeed 

has an opcode 70 which produces 8 blank scan lines on the video screen. By 

by one block. As an example, we will insert opcode 70 (8 blank scan lines) 
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"MIXED CIS" will activate the new list. Press the RETURN key a few times 
J notice how the output routines seem to ignore the blank scan lines. The 
IMS command is a plural form of the DBIN command. Let's insert a different 
:ode other than 2 or $F. Opcode 6 is a mode which displays colored characters 
ich are much larger than normal. This will insert three opcode 6's at block 9 

6 9 DBINS 

Activate this new list in the normal way and experiment with it. The 
Mowing section describes all of the available opcodes. Experiment with these 
you read about them and you should have no problem understanding any of them. 

This brief explanation of display list formatting should show the power 
lilable to the programmer who wants to get that unique display. There are 
■y more commands available for use. These are explained thoroughly in the 
Dssary at the end of the next section. 
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There are four basic display list instructions. Those that produce blank 
scan lines, the display list jump, the jump on vertical blank, and the display 
block instructions. This is a description of these four basic instructions. 


Blank Scan Lines 















This opcode produces n+1 blank scan lines of color BAK. No video 
memory is used by this instruction. 

If the I bit is set, a display list interrupt (DLI) will occur upon 
interpretation by Antic (the video processor). 


$40 = 64 

$50 = 80 


Display List Jump 








- —1 -— 













The low byte of the address is found lower in memory. 

absolutely forbidden. Future releases may have this implemented. 

If the I bit is set, a display list interrupt will occur upon 
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Jump On Vertical Blank 


Byte form: 










This three byte opcode instructs Antic to transfer display list 
interpretation to the address specified by the following two bytes (low 
byte of address first) and to pause until vertical blank occurs. Since 
display list processing halts, any remaining portion of the video display 
takes on the color of BAK. This command is not to be entered by the user. 
The display formatter automatically adds this to the end of the display 
list whenever it is moved or activated. 

If the I bit is set, a display list interrupt will occur upon inter¬ 
pretation by Antic. 

Legal form: 

$41 addr-low addr-hi 




Byte form: 




There are 14 display modes. Six are character modes, eight are 
graphic modes. Each of these modes varies greatly and will be discussed 

If set, the J bit instructs Antic to perform a display memory jump. 
Antic expects the next two bytes in the display list to point to the new 
display memory location. The first display block instruction should 
always have this bit set. Also, Antic cannot properly retrieve data 

must cross a 4K boundary, a display memory jump must be used. Note that 
the display formatter automatically takes care of these two problems for 

If set, the V bit informs Antic that the current display block is 
to be vertically scrolled upward according to the value in VSCROL (address 
$D405). Note that vertical scrolling is accomplished only if two or more 
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If set, the H bit informs Antic that the current display block is 

(address $D404). Note that for horizontally scrolled display blocks, 
extra bytes of memory are needed. The exact number of bytes varies for 
different screen (playfield) widths. Use the following calculation: 

where: X = the number of characters/display block 

There are no extra bytes for the wide playfield setting. 

For example, a 40 character/line display block in the standard 
width would use a total of 40 + 40/5 or 48 characters. Note that only 
one of these extra bytes is actually used for the display. 
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The Character Modes 


There are 6 character modes (opcodes 2 thru 7). All character modes 
work in the same way, i,e., the values in display memory are indices to 
a large "n" by 8 byte array. In some of these modes, the highest one or 
two bits are used to specify a color with only the remaining lower bits 
used for indexing. The following table gives information about each of 
the modes: 


Antic mode 






7 




















16 


Chars/line 





20 


wide screen 





























= PF1 etc. 
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There are 8 graphic modes. Unlike character modes, the values in 
display memory are not indices into an array of character definitions, 
but rather are the definitions themselves. Depending on the graphic mode, 
these values give different results. The following table gives various 
information about each mode. 


Antic mode 








F* 

Basic mode 
































20 



40 

wide screen 

















320 
















2 













*Mode F values differ when in GTIA modes 


11 = PF2 
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( dmem dlist — ) 

the target address for the display list. The address found second on the 
stack is the target address for display memory. The display list is 
actually created in a c-array named DSPLST. Note that while building the 
list, no check is made to ensure that the display' list does not cross a IK 
memory boundary. 


( — ) 

Like the (DBINIT) command above, this initializes the display formatter. 
But unlike (DBINIT), this expects no arguments. Instead, these values are 
calculated automatically. The display memory address is top of memory 
minus 1F00 hex. This is enough for a full graphics 8 screen. The display 
list address is 256 bytes below the display memory address. Note that this 
is very memory wasteful, and should only be used while still learning the 


DBPTR 


( block# — ) 







"antic-mode" to the end of the current display 
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DBMS (cont’d) 

Mixed lists are also possible: 

160 15 DBMS 
4 2 DBMS 



This would create a screen of 160 graphic 8 lines with four text lines at 
the bottom. 


DBIN 


antic-mode block# --- ) 


Oftentimes, it is desirable to slightly change the existing display 
list to obtain special effects midway through a running program. The DBIN 
command allows insertion of new display blocks within the current display 
list. This command inserts "antic-mode" into the block specified by 
"block#". Whatever was in the block "block#" and following is pushed 
back one block. For example: 







The DBIN allows the user to create new display lists without the need to 
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( #times antic-mode block# --- ) 

This command repeats "antic-mode block# DBIN" the specified number 


The DBDEL command serves as the logical complement to the DBIN 
command. Thus, after inserting a temporary display block, the DBDEL 
command may be used to delete that display block once it is no longer 
needed: 



1 DBDEL would give: 



{ -times block# — ) 
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DBDELL 






at the end of the current display list, 
command as its use is rather limited. 

Occasionally, it is desirable to know what antic-mode is being used 
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DBMOD (cont'd) 

There are several methods in which to put more than one modifier on a 

To attach all three modifiers, the best method is: 


It should also be noted that it is possible to create modified display 
blocks, thus reducing the need for the DBMOD command: 

horizontal and vertical scroll modifiers: 




ly be used on antic-modes 2 through 15 


The last line leaves only the vertical modifier, if present, or leaves 0 
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DBREML 






USRDSP 




DMPLST 








DMCLR 
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In addition, there are various variables available to the programmer: 
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XXXII. DISPLAY FORMATTER SUPPLIED SOURCE LISTING 
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